NAVNavbar
Logo
cURL php NodeJS Python cSharp

Content Analysis – Search API


This endpoint will provide you with detailed citation data available for the target keyword.

Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access

<?php
// You can download this file from here https://cdn.dataforseo.com/v3/examples/php/php_RestClient.zip
require('RestClient.php');
$api_url = 'https://api.dataforseo.com/';
// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
$client = new RestClient($api_url, null, 'login', 'password');
$post_array = array();
// simple way to set a task
$post_array[] = array(
   "keyword" => "logitech",
   "keyword_fields" => array(
      "snippet" => "logitech"
   ),
   "page_type" => array(
      "ecommerce",
      "news",
      "blogs",
      "message-boards",
      "organization"
   ),
   "search_mode" => "as_is",
   "filters" => array(
      "main_domain",
      "=",
      "reviewfinder.ca"
   ),
   "internal_list_limit" => 8,
   "order_by" => array(
      "content_info.sentiment_connotations.anger,desc"
   ),
   "limit" => 10
);
try {
   // POST /v3/content_analysis/search/live
   $result = $client->post('/v3/content_analysis/search/live', $post_array);
   print_r($result);
   // do something with post result
} catch (RestClientException $e) {
   echo "n";
   print "HTTP code: {$e->getHttpCode()}n";
   print "Error code: {$e->getCode()}n";
   print "Message: {$e->getMessage()}n";
   print  $e->getTraceAsString();
   echo "n";
}
$client = null;
?>

The above command returns JSON structured like this:

{
  "version": "0.1.20220913",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.5305 sec.",
  "cost": 0.0203,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "09131957-0696-0463-0000-7db1bf7abc2b",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.4865 sec.",
      "cost": 0.0203,
      "result_count": 1,
      "path": [
        "v3",
        "content_analysis",
        "search",
        "live"
      ],
      "data": {
        "api": "content_analysis",
        "function": "search",
        "keyword_fields": {
          "snippet": "logitech"
        },
        "page_type": [
          "ecommerce",
          "news",
          "blogs",
          "message-boards",
          "organization"
        ],
        "search_mode": "as_is",
        "filters": [
          "main_domain",
          "=",
          "reviewfinder.ca"
        ],
        "internal_list_limit": 8,
        "limit": 10
      },
      "result": [
        {
          "offset_token": "eyJWZXJzaW9uIjoxLCJTZWFyY2hBZnRlclZhbHVlcyI6eyJjb250ZW50cy5zZW50aW1lbnRfY29ubm90YXRpb25zLmFuZ3J5IjowLjA5NzU2Nzc1LCJfc2NvcmUiOjIxNTUuNDk0MSwidXJsX2hhc2giOiIzNDM1OTM5MjM3NTMzMTExNDQ1In0sIlRva2VuUmVhbE9mZnNldCI6MH0=",
          "total_count": 296,
          "items_count": 10,
          "items": [
            {
              "type": "content_analysis_search",
              "url": "https://reviewfinder.ca/top-computer-speakers/edifier-r1280db-vs-logitech-g560/",
              "domain": "reviewfinder.ca",
              "main_domain": "reviewfinder.ca",
              "url_rank": 126,
              "spam_score": 0,
              "domain_rank": 493,
              "fetch_time": "2022-08-12 18:40:33 +00:00",
              "country": "CA",
              "language": "en",
              "score": 5900.941,
              "page_category": [
                10019,
                10167,
                10873,
                12138,
                10002,
                10028,
                10222,
                13813
              ],
              "page_types": [
                "ecommerce"
              ],
              "ratings": null,
              "social_metrics": [
                {
                  "type": "facebook",
                  "like_count": 13
                }
              ],
              "content_info": {
                "content_type": "page_content",
                "title": "Verdict",
                "main_title": "Comparing Edifier R1280DB and Logitech G560",
                "previous_title": "Endorsement summary:",
                "level": 2,
                "author": null,
                "snippet": "After counting and adding up the 77 expert endorsements of the May rankings, Logitech G560 outranks Edifier R1280DB. This is not to say that Edifier R1280DB is a bad option. Like Logitech G560, it is recommended by experts, but less.\nAs can be seen below, Logitech G560 outranks Edifier R1280DB by 13 positions. This indicates that, as of 4 Aug 2022, Logitech G560 is more critically acclaimed than Edifier R1280DB.",
                "snippet_length": 415,
                "social_metrics": [
                  {
                    "type": "facebook",
                    "like_count": 13
                  }
                ],
                "highlighted_text": null,
                "language": "en",
                "sentiment_connotations": {
                  "anger": null,
                  "happiness": 0.07077454775571823,
                  "love": 0.0959794893860817,
                  "sadness": 0.030060304328799248,
                  "share": null,
                  "fun": 0.15295149385929108
                },
                "connotation_types": {
                  "positive": 0.12338598817586899,
                  "negative": 0.41213861107826233,
                  "neutral": 0.4645053744316101
                },
                "text_category": [
                  10019,
                  10167,
                  10873,
                  12138,
                  10013
                ],
                "date_published": null,
                "content_quality_score": 90,
                "semantic_location": 90,
                "rating": null,
                "group_date": "2021-09-08 20:23:59 +00:00"
              }
            },
            {
              "type": "content_analysis_search",
              "url": "https://reviewfinder.ca/info/top-gaming-racing-wheels/logitech-g920/",
              "domain": "reviewfinder.ca",
              "main_domain": "reviewfinder.ca",
              "url_rank": 64,
              "spam_score": 0,
              "domain_rank": 493,
              "fetch_time": "2022-07-31 20:16:34 +00:00",
              "country": "CA",
              "language": "en",
              "score": 5751.833,
              "page_category": [
                10108,
                10019,
                10167
              ],
              "page_types": [
                "ecommerce"
              ],
              "ratings": null,
              "social_metrics": null,
              "content_info": {
                "content_type": "page_content",
                "title": "Logitech G920 - Recommended and relevant!",
                "main_title": "Logitech G920 - Reviews, Prices, Specs and Alternatives",
                "previous_title": "ReviewFinder Gaming Racing Wheels Logitech G920",
                "level": 2,
                "author": null,
                "snippet": "According to the meta ranking published on 3 July 2022, Logitech G920 is currently recommended as a high-quality Racing Wheel. Out of 10 expert opinions queried, Logitech G920 received 4 endorsements, from TechRadar (8 Jun 2022), Android Authority (12 Sep 2021) BestCovery (7 Apr 2022) and 1 other..\n1 out of 4 experts ranked Logitech G920 as 'the best Racing Wheel of the month'.\nCompared to other most critically acclaimed Gaming Racing Wheels, Logitech G920 ranks #5 out of 15 in July 2022, - as can be seen from the table below.\nThe definitive sim racing wheel for Xbox One: Realistic steering and pedal action for the latest racing titles. Wheel spokes: Anodized aluminum\nBuilt to last: Durable solid steel ball bearings, stainless steel pedals and hand-stitched leather wheel grip. Glass-filled nylon mounting clamps\nDual-motor force feedback: Realistically simulates the racing experience with smooth, quiet helical gearing\nEasy-access game controls: On-wheel D-pad, console buttons and paddle shifters\nResponsive floor pedal unit: Accelerate, brake and change gears with the feel of an actual car.System requirement:Windows 10, 8.1, Windows 8 or Windows 7 and macOS 10.10+\nLogitech has different serial numbers for packaging vs. product, please keep your receipt for warranty purposes.\nAs can be seen from the ranking below, Logitech G920 is endorsed by the critics this months, and ranks #5.",
                "snippet_length": 1400,
                "social_metrics": null,
                "highlighted_text": null,
                "language": "en",
                "sentiment_connotations": {
                  "anger": null,
                  "happiness": 0.15027441084384918,
                  "love": 0.1787649393081665,
                  "sadness": 0.09101732820272446,
                  "share": null,
                  "fun": 0.0640750378370285
                },
                "connotation_types": {
                  "positive": 0.34157365560531616,
                  "negative": 0.3285507559776306,
                  "neutral": 0.32990556955337524
                },
                "text_category": [
                  10013,
                  10019,
                  10167
                ],
                "date_published": null,
                "content_quality_score": 94,
                "semantic_location": 94,
                "rating": null,
                "group_date": "2021-09-13 05:05:18 +00:00"
              }
            },
            {
              "type": "content_analysis_search",
              "url": "https://reviewfinder.ca/info/top-gaming-racing-wheels/logitech-g27/",
              "domain": "reviewfinder.ca",
              "main_domain": "reviewfinder.ca",
              "url_rank": 104,
              "spam_score": 0,
              "domain_rank": 493,
              "fetch_time": "2022-07-31 21:22:19 +00:00",
              "country": "CA",
              "language": "en",
              "score": 2685.8352,
              "page_category": [
                10108,
                10002,
                10028,
                10222,
                13813
              ],
              "page_types": [
                "ecommerce"
              ],
              "ratings": null,
              "social_metrics": null,
              "content_info": {
                "content_type": "page_content",
                "title": "ReviewFinder Gaming Racing Wheels Logitech G27",
                "main_title": "Logitech G27 - Reviews, Prices, Specs and Alternatives",
                "previous_title": "Logitech G27 - Reviews, Prices, Specs and Alternatives",
                "level": 3,
                "author": null,
                "snippet": "The powerful, dual-motor force feedback mechanism with helical gearing smoothly and accurately simulates traction loss\nSix-speed shifter with push-down reverse gear allows you to quickly choose exactly the right gear.\nRPM/shift indicator LEDs integrate with racing game software to indicate when the user should shift gears.\nRealistic 11-Inch wheel with leather-wrapped rim provides a more comfortable, true-to-life racing experience for hours on end.\nSteel gas, brake, and clutch pedals deliver precise throttle, braking, and shifting control for heightened realism.\nThe powerful dual-motor force feedback mechanism with helical gearing smoothly and accurately simulates traction loss\nSix-speed shifter with push-down reverse gear allows you to quickly choose exactly the right gear\nRPM/shift indicator LEDs integrate with racing game software to indicate when the user should shift gears\nRealistic 11-Inch wheel with leather-wrapped rim provides a more comfortable and true-to-life racing experience for hours on end\nSteel gas, brake and clutch pedals deliver precise throttle with braking and shifting control for heightened realism\nLogitech G27 is a popular option at the top of the price range. It's in the top 3 bestselling racing wheels and has doesn't have many popular alternatives in the same price range.\nLogitech G27 is C$2814.58 more expensive than the average racing wheel (C$337.16).",
                "snippet_length": 1398,
                "social_metrics": null,
                "highlighted_text": null,
                "language": "en",
                "sentiment_connotations": {
                  "anger": null,
                  "happiness": 0.05615948140621185,
                  "love": 0.09969528764486313,
                  "sadness": 0.15229091048240662,
                  "share": null,
                  "fun": 0.0502193346619606
                },
                "connotation_types": {
                  "positive": 0.5877373814582825,
                  "negative": 0.0651920959353447,
                  "neutral": 0.34710052609443665
                },
                "text_category": [
                  10019,
                  10167,
                  10013
                ],
                "date_published": null,
                "content_quality_score": 90,
                "semantic_location": 90,
                "rating": null,
                "group_date": "2019-08-19 03:00:33 +00:00"
              }
            },
            {
              "type": "content_analysis_search",
              "url": "https://reviewfinder.ca/info/top-computer-speakers/logitech-z213/",
              "domain": "reviewfinder.ca",
              "main_domain": "reviewfinder.ca",
              "url_rank": 137,
              "spam_score": 0,
              "domain_rank": 493,
              "fetch_time": "2022-08-13 11:12:47 +00:00",
              "country": "CA",
              "language": "en",
              "score": 4299.2095,
              "page_category": [
                10013,
                10108
              ],
              "page_types": [
                "ecommerce"
              ],
              "ratings": null,
              "social_metrics": null,
              "content_info": {
                "content_type": "page_content",
                "title": "ReviewFinder Computer Speakers Logitech Z213",
                "main_title": "Logitech Z213 - Reviews, Prices, Specs and Alternatives",
                "previous_title": "Logitech Z213 - Reviews, Prices, Specs and Alternatives",
                "level": 3,
                "author": null,
                "snippet": "Down-firing subwoofer with adjustable bass control knob: Turn up the bass to add a deeper, richer low end to your music, movies and games\n14W peak power (7W RMS): Enjoy all your audio entertainment in loud, clear stereo sound\nConvenient handheld control pod: Easily power on the speakers, adjust volume and plug in your headset for private listening\nCompact satellite speakers: Inclined design directs great sound to your ears without sacrificing valuable desk space\nPlug-and-play setup: Simple wired connection to audio devices with 3.5mm output (Windows and Mac computers, smartphones, tablets, MP3 players)\nLogitech has different serial numbers for packaging vs. product, please keep your receipt for warranty purposes.\nSpeaker System Type:Multimedia Speakers\nConnections:Inputs: 3.5mm auxiliary input ;Outputs: 3.5mm headphone jack;\nNominal Output Power (Total):14 Watt\nMax (RMS) Output Power (Total):7 Watt\nService & Support Type:1-Year Limited Hardware Warranty\nLogitech Z213 is a very popular option in the middle of the computer speakers price range. It has dozens of popular alternatives in the same price range, such as Edifier R19U or Sanyun SW102.\nLogitech Z213 is C$25.56 cheaper than the average computer speaker (C$71.55).",
                "snippet_length": 1237,
                "social_metrics": null,
                "highlighted_text": null,
                "language": "en",
                "sentiment_connotations": {
                  "anger": null,
                  "happiness": 0.15706565976142883,
                  "love": 0.19101671874523163,
                  "sadness": 0.027795027941465378,
                  "share": null,
                  "fun": 0.06868279725313187
                },
                "connotation_types": {
                  "positive": 0.36061927676200867,
                  "negative": 0.1687621772289276,
                  "neutral": 0.47064855694770813
                },
                "text_category": [
                  10019,
                  10167,
                  10873,
                  12138,
                  10872
                ],
                "date_published": null,
                "content_quality_score": 95,
                "semantic_location": 95,
                "rating": null,
                "group_date": "2021-08-07 07:56:41 +00:00"
              }
            },
            {
              "type": "content_analysis_search",
              "url": "https://reviewfinder.ca/info/top-gaming-racing-wheels/logitech-g29/",
              "domain": "reviewfinder.ca",
              "main_domain": "reviewfinder.ca",
              "url_rank": 79,
              "spam_score": 0,
              "domain_rank": 493,
              "fetch_time": "2022-07-31 20:08:57 +00:00",
              "country": "CA",
              "language": "en",
              "score": 5864.53,
              "page_category": [
                10108,
                10013
              ],
              "page_types": [
                "ecommerce"
              ],
              "ratings": null,
              "social_metrics": null,
              "content_info": {
                "content_type": "page_content",
                "title": "Logitech G29 - Recommended and relevant!",
                "main_title": "Logitech G29 - Reviews, Prices, Specs and Alternatives",
                "previous_title": "ReviewFinder Gaming Racing Wheels Logitech G29",
                "level": 2,
                "author": null,
                "snippet": "According to the meta ranking published on 3 July 2022, Logitech G29 is currently recommended as a high-quality Racing Wheel. Out of 10 expert opinions queried, Logitech G29 received 4 endorsements, from TechRadar (8 Jun 2022), Android Authority (12 Sep 2021) PCreview (9 Jan 2022) and 1 other..\nNo experts ranked Logitech G29 as 'the best Racing Wheel of July'.\nCompared to other most critically acclaimed Gaming Racing Wheels, Logitech G29 ranks #8 out of 15 in July 2022, - as can be seen from the table below.\nThe definitive SIM racing wheel for PlayStation 4 and PlayStation 3: realistic steering and pedal action for the latest racing titles. Note: Kindly refer the User manual before usage of the product\nBuilt to last: durable solid steel ball bearings, stainless steel shifter and PEDALS and hand-stitched leather wheel grip. Hall-effect steering sensor. Wheel spokes material: Anodized aluminum\nDual-motor force feedback: realistically simulates the racing experience with smooth, quiet Helical gearing. 900° wheel rotation\nSytem requirement:Windows 10, 8.1, Windows 8 or Windows 7 and macOS 10.10+\nWheel Unit Depth is 278 mm; Pedal piston sleeves: Polyoxymethylene thermoplastic (POM)\nAs can be seen from the ranking below, Logitech G29 is endorsed by the critics this months, and ranks #8.",
                "snippet_length": 1301,
                "social_metrics": null,
                "highlighted_text": null,
                "language": "en",
                "sentiment_connotations": {
                  "anger": null,
                  "happiness": 0.13903042674064636,
                  "love": 0.14059056341648102,
                  "sadness": 0.09468089044094086,
                  "share": null,
                  "fun": 0.061122357845306396
                },
                "connotation_types": {
                  "positive": 0.39891257882118225,
                  "negative": 0.30477818846702576,
                  "neutral": 0.2963393032550812
                },
                "text_category": [
                  10013,
                  10019,
                  10167
                ],
                "date_published": null,
                "content_quality_score": 94,
                "semantic_location": 94,
                "rating": null,
                "group_date": "2021-09-13 05:08:30 +00:00"
              }
            },
            {
              "type": "content_analysis_search",
              "url": "https://reviewfinder.ca/top-gaming-keyboards/logitech-g213-vs-razer-cynosa-chroma/",
              "domain": "reviewfinder.ca",
              "main_domain": "reviewfinder.ca",
              "url_rank": 146,
              "spam_score": 0,
              "domain_rank": 493,
              "fetch_time": "2022-08-11 23:21:00 +00:00",
              "country": "CA",
              "language": "en",
              "score": 4562.6978,
              "page_category": [
                10108,
                13691,
                10011
              ],
              "page_types": [
                "ecommerce"
              ],
              "ratings": null,
              "social_metrics": null,
              "content_info": {
                "content_type": "page_content",
                "title": "Experts prefer Razer Cynosa Chroma over Logitech G213 Prodigy",
                "main_title": "Comparing Logitech G213 Prodigy and Razer Cynosa Chroma",
                "previous_title": "Razer Cynosa Chroma",
                "level": 2,
                "author": null,
                "snippet": "Currently, Razer Cynosa Chroma received 1 endorsement from PC Gamer (27 Jul 2022). Meanwhile, Logitech G213 Prodigy did not receive any endorsements this month.\nCurious to see this month's entire Gaming Keyboards ranking? It's here",
                "snippet_length": 231,
                "social_metrics": null,
                "highlighted_text": null,
                "language": "en",
                "sentiment_connotations": {
                  "anger": null,
                  "happiness": 0.07467446476221085,
                  "love": 0.18654434382915497,
                  "sadness": 0.14675261080265045,
                  "share": null,
                  "fun": 0.08801265060901642
                },
                "connotation_types": {
                  "positive": 0.22597165405750275,
                  "negative": 0.5552403926849365,
                  "neutral": 0.21881794929504395
                },
                "text_category": [
                  10108,
                  13691,
                  10013
                ],
                "date_published": null,
                "content_quality_score": 96,
                "semantic_location": 96,
                "rating": null,
                "group_date": "2021-09-08 12:27:37 +00:00"
              }
            },
            {
              "type": "content_analysis_search",
              "url": "https://reviewfinder.ca/info/top-surround-speaker-systems/acoustic-audio-aa5210/",
              "domain": "reviewfinder.ca",
              "main_domain": "reviewfinder.ca",
              "url_rank": 120,
              "spam_score": 0,
              "domain_rank": 493,
              "fetch_time": "2022-08-13 21:56:48 +00:00",
              "country": "CA",
              "language": "en",
              "score": 1411.0455,
              "page_category": [
                10019,
                10167,
                10873,
                12138,
                10872
              ],
              "page_types": [
                "ecommerce"
              ],
              "ratings": null,
              "social_metrics": null,
              "content_info": {
                "content_type": "page_content",
                "title": "ReviewFinder Surround Speaker Systems Acoustic Audio AA5210",
                "main_title": "Acoustic Audio AA5210 - Reviews, Prices, Specs and Alternatives",
                "previous_title": "Acoustic Audio AA5210 - Reviews, Prices, Specs and Alternatives",
                "level": 3,
                "author": null,
                "snippet": "Acoustic Audio AA5210 powered 5.1 Bluetooth home theater speaker system with USB / SD, 600 watts system power, frequency response is 20hz-20 kHz, magnetically shielded satellite speakers\nIntegrated Bluetooth receiver and amplifier, 5 independent channel inputs and outputs, enhanced bass boost design, bass, treble and main controls, stereo AUX input, pro surround function, USB/SD card reader\nPlug and play connections, LED illuminated sub with multiple pattern flashing light display, 1 subwoofer speaker is (H x W x D) 11\" x 6.25\" x 12.5\", 5 full range satellite speakers are (H x W x D) 6.875\" x 4.125\" x 4\" each\n2 Fronts and 1 center satellite speakers have a 6' single RCA cable, 2 rear speakers have 12' single RCA cables, 3.5mm AUX to RCA cable included, 2 RCA to RCA cables included, remote control and full instructions included\nUse for home entertainment system, laptop or PC, DVD player, gaming, MP3 player, cell phone, tablet or any other device with a 3.5mm headphone output or RCA audio output\nAcoustic Audio AA5210 is a very popular and one of the less expensive options. It's in the top 3 bestselling speaker systems and has a couple of popular alternatives in the same price range, such as Monoprice 5.1 Home Theater or Logitech Z606.\nAcoustic Audio AA5210 is C$383 less expensive than an average speaker system (C$583.42).",
                "snippet_length": 1341,
                "social_metrics": null,
                "highlighted_text": null,
                "language": "en",
                "sentiment_connotations": {
                  "anger": null,
                  "happiness": 0.0951547920703888,
                  "love": 0.326175719499588,
                  "sadness": 0.021449072286486626,
                  "share": null,
                  "fun": 0.020081015303730965
                },
                "connotation_types": {
                  "positive": 0.2667571008205414,
                  "negative": 0.198574036359787,
                  "neutral": 0.5346988439559937
                },
                "text_category": [
                  10019,
                  10167,
                  10873,
                  12138,
                  12137
                ],
                "date_published": null,
                "content_quality_score": 93,
                "semantic_location": 93,
                "rating": null,
                "group_date": "2021-08-30 15:38:32 +00:00"
              }
            },
            {
              "type": "content_analysis_search",
              "url": "https://reviewfinder.ca/info/top-gaming-keyboards/logitech-g910/",
              "domain": "reviewfinder.ca",
              "main_domain": "reviewfinder.ca",
              "url_rank": 121,
              "spam_score": 0,
              "domain_rank": 493,
              "fetch_time": "2022-07-21 17:59:12 +00:00",
              "country": "CA",
              "language": "en",
              "score": 5116.254,
              "page_category": [
                10108,
                10013
              ],
              "page_types": [
                "ecommerce"
              ],
              "ratings": null,
              "social_metrics": null,
              "content_info": {
                "content_type": "page_content",
                "title": "ReviewFinder Gaming Keyboards Logitech G910",
                "main_title": "Logitech G910 - Reviews, Prices, Specs and Alternatives",
                "previous_title": "Logitech G910 - Reviews, Prices, Specs and Alternatives",
                "level": 3,
                "author": null,
                "snippet": "Connectivity Type Wired. Connectivity USB. Bluetooth No. Cord Length or Cordless Range 1.8 m. Ergonomic Design No. Keyboard Language English. Built-in TrackpadTouchpad No. Backlit Keys Yes. Internet Keys 0. Multimedia Keys 5. Mechanical Keys Yes. Custom Programmable Buttons 9 Fully Programmable G Keys. LCD Display No. Number of Memory Profile(s) 3. Colour Black. Wrist Rest Included Yes. Integrated USB Ports 0.\nDesigned For Gaming Yes. Solar Powered No. Battery Life Indicator No. Rechargeable No. System Requirements Windows 788.1 Powered USB Port Internet Connection 100MB Hard Drive Space (for Optional Software Download). Width 50.5 cm. Height 3.5 cm. Depth 24.4 cm. Weight 1.5 kg. Width (Inches) 19.7 in. Height (Inches) 1.37 in. Depth (Inches) 9.52 in. Warranty Parts 2 Year(s).\nLogitech Mechanical Gaming Keyboard.\nLogitech G910 is a very popular and one of the most expensive options. It's in the top 3 bestselling gaming keyboards and has many popular alternatives in the same price range, such as Logitech G810 Orion or Corsair K70 RGB MK.2.\nLogitech G910 is C$86.75 more expensive than an average gaming keyboard (C$104.95).",
                "snippet_length": 1138,
                "social_metrics": null,
                "highlighted_text": null,
                "language": "en",
                "sentiment_connotations": {
                  "anger": null,
                  "happiness": 0.09535221010446548,
                  "love": 0.2098393738269806,
                  "sadness": 0.13099771738052368,
                  "share": null,
                  "fun": 0.035219766199588776
                },
                "connotation_types": {
                  "positive": 0.18018507957458496,
                  "negative": 0.16152001917362213,
                  "neutral": 0.6583248972892761
                },
                "text_category": [
                  10019,
                  10167,
                  10013
                ],
                "date_published": null,
                "content_quality_score": 94,
                "semantic_location": 94,
                "rating": null,
                "group_date": "2021-08-28 00:43:56 +00:00"
              }
            },
            {
              "type": "content_analysis_search",
              "url": "https://reviewfinder.ca/info/top-gaming-keyboards/logitech-g213/",
              "domain": "reviewfinder.ca",
              "main_domain": "reviewfinder.ca",
              "url_rank": 121,
              "spam_score": 0,
              "domain_rank": 493,
              "fetch_time": "2022-07-21 16:59:42 +00:00",
              "country": "CA",
              "language": "en",
              "score": 4598.567,
              "page_category": [
                10108,
                10013
              ],
              "page_types": [
                "ecommerce"
              ],
              "ratings": null,
              "social_metrics": null,
              "content_info": {
                "content_type": "page_content",
                "title": "ReviewFinder Gaming Keyboards Logitech G213 Prodigy",
                "main_title": "Logitech G213 Prodigy - Reviews, Prices, Specs and Alternatives",
                "previous_title": "Logitech G213 Prodigy - Reviews, Prices, Specs and Alternatives",
                "level": 3,
                "author": null,
                "snippet": "Brilliant color spectrum illumination - personalize five individual lighting zones from a spectrum of over 16.8 million colors. Change colors to match your setup, specific games, or to showcase your favorite colors. Synchronize lighting effects with other Logitech G devices using Logitech gaming software. Low light leak around each keycap means less more light comes through the lettering – and less leaks around the keycaps. This helps make the illumination of each key more brilliant, making it easier to find your keys in the dark\nComfortable and durable - G213 prodigy is a full-sized keyboard designed for gaming and productivity. The slim body is built for gamers of all levels, with a durable construction that repels liquids, crumbs and dirt for easy cleanup. An integrated palm rest and adjustable feet let you set your keyboard to the ideal position, so it’s comfortable to use even during the longest gaming sessions\nPerformance tuned with multi-key input - G213 brings together the best in tactile feel and performance with keys built specifically for the way gamers play. Each key on the G213 is tuned to enhance the tactile experience, delivering ultra-quick, responsive feedback that is up to 4 times faster than standard keyboards. The anti-ghosting gaming Matrix is tuned for optimal gaming performance, keeping you in control when you press multiple gaming keys simultaneously\nDedicated media controls - control your background track without switching out of your game. G213 features dedicated media controls that can be used to play, pause and mute music and videos instantly. Adjust the volume, or skip to the next song with the touch of a button\nCustomize with Logitech gaming software - Logitech gaming software lets you fully customize your G213 for added convenience and personalization. Set the RGB lighting, save time by assigning multiple functions to function (F1-F12) keys, and much more\nLogitech G213 Prodigy is a popular and one of the less expensive options. It's in the top 3 bestselling gaming keyboards and has dozens of popular alternatives in the same price range, such as Corsair K55 RGB or Razer Cynosa V2.\nLogitech G213 Prodigy is C$34.19 less expensive than an average gaming keyboard (C$104.95).",
                "snippet_length": 2239,
                "social_metrics": null,
                "highlighted_text": null,
                "language": "en",
                "sentiment_connotations": {
                  "anger": null,
                  "happiness": 0.05594038963317871,
                  "love": 0.4099886119365692,
                  "sadness": 0.037346553057432175,
                  "share": null,
                  "fun": 0.029315805062651634
                },
                "connotation_types": {
                  "positive": 0.45417067408561707,
                  "negative": 0.13158488273620605,
                  "neutral": 0.4142744541168213
                },
                "text_category": [
                  10019,
                  10168,
                  10886,
                  12222,
                  10167
                ],
                "date_published": null,
                "content_quality_score": 94,
                "semantic_location": 94,
                "rating": null,
                "group_date": "2021-08-28 00:43:49 +00:00"
              }
            },
            {
              "type": "content_analysis_search",
              "url": "https://reviewfinder.ca/top-xbox-one-headsets/astro-a10-gaming-headset-vs-lucidsound-ls35x/",
              "domain": "reviewfinder.ca",
              "main_domain": "reviewfinder.ca",
              "url_rank": 165,
              "spam_score": 0,
              "domain_rank": 493,
              "fetch_time": "2022-08-11 00:13:11 +00:00",
              "country": "CA",
              "language": "en",
              "score": 2155.4941,
              "page_category": [
                10002,
                10231,
                13469,
                10011
              ],
              "page_types": [
                "ecommerce"
              ],
              "ratings": null,
              "social_metrics": null,
              "content_info": {
                "content_type": "page_content",
                "title": "Score distribution:",
                "main_title": "Comparing Astro A10 and LucidSound LS35X",
                "previous_title": "Expert reviews [1]",
                "level": 4,
                "author": null,
                "snippet": "Durable construction – The A10 was designed to withstand serious abuse, featuring a lightweight yet rugged construction with premium materials for a pressure-free fit that won’t overheat your head. The ear cushions contain cloth for maximum comfort, backed with synthetic leather for the best acoustic performance.\nCombat Ready Precision Audio: Our focus is delivering flawless high quality PC and console audio that delivers total immersion into your game and precision audio to provide a competitive advantage. No one will be able to sneak up behind you with LucidSound on your team.\nNo manufacturer information linked for LucidSound LS35X.\nAstro A10 is a very popular option in the middle of the headsets price range. It's in the top 3 bestselling headsets and has dozens of popular alternatives in the same price range, such as Somic G951S or Logitech G332.\nAstro A10 is C$0.02 more expensive than an average headset (C$59.97).",
                "snippet_length": 931,
                "social_metrics": null,
                "highlighted_text": null,
                "language": "en",
                "sentiment_connotations": {
                  "anger": null,
                  "happiness": 0.10993830859661102,
                  "love": 0.1934281885623932,
                  "sadness": 0.039923928678035736,
                  "share": null,
                  "fun": 0.04024559631943703
                },
                "connotation_types": {
                  "positive": 0.34128379821777344,
                  "negative": 0.259573370218277,
                  "neutral": 0.39917290210723877
                },
                "text_category": [
                  10013,
                  10019,
                  10167
                ],
                "date_published": null,
                "content_quality_score": 94,
                "semantic_location": 94,
                "rating": null,
                "group_date": "2021-09-08 22:26:11 +00:00"
              }
            }
          ]
        }
      ]
    }
  ]
}

All POST data should be sent in the JSON format (UTF-8 encoding). The task setting is done using the POST method. When setting a task, you should send all task parameters in the task array of the generic POST array. You can send up to 2000 API calls per minute.

You can specify the number of results you want to retrieve, filter and sort them.

Below you will find a detailed description of the fields you can use for setting a task.

Description of the fields for setting a task:

Field name Type Description
keyword string target keyword
required field
UTF-8 encoding
the keywords will be converted to a lowercase format;
Note: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes;
example:
"keyword": "\"tesla palo alto\""

learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article

keyword_fields object target keyword fields and target keywords
optional field
use this parameter to filter the dataset by keywords that certain fields should contain;
fields you can specify: title, main_title, previous_title, snippet
you can indicate several fields;
Note: to match an exact phrase instead of a stand-alone keyword, use double quotes and backslashes;
example:
"keyword_fields": {
  "snippet": "\"logitech mouse\"",
  "main_title": "sale"
}
page_type array target page types
optional field
use this parameter to filter the dataset by page types
possible values:
"ecommerce", "news", "blogs", "message-boards", "organization"
search_mode string results grouping type
optional field
possible grouping types:
as_is – returns all citations for the target keyword
one_per_domain – returns one citation of the keyword per domain
default value: as_is
limit integer the maximum number of returned citations
optional field
default value: 100
maximum value: 1000
filters array array of results filtering parameters
optional field
you can add several filters at once (8 filters maximum)
you should set a logical operator and, or between the conditions
the following operators are supported:
regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like
you can use the % operator with like and not_like to match any string of zero or more characters
example:
["country","=", "US"]

[["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]]

[["domain_rank",">",800],
"and",
[["page_types","has","ecommerce"],
"or",
["content_info.text_category","has",10994]]]

for more information about filters, please refer to Content Analysis API – Filters

order_by array results sorting rules
optional field
you can use the same values as in the filters array to sort the results
possible sorting types:
asc – results will be sorted in the ascending order
desc – results will be sorted in the descending order
you should use a comma to set up a sorting type
example:
["content_info.sentiment_connotations.anger,desc"]
default rule:
["content_info.sentiment_connotations.anger,desc"]
note that you can set no more than three sorting rules in a single request
you should use a comma to separate several sorting rules
example:
["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"]
offset integer offset in the results array of returned citations
optional field
default value: 0
if you specify the 10 value, the first ten citations in the results array will be omitted and the data will be provided for the successive citations
offset_token string offset token for subsequent requests
optional field
provided in the identical field of the response to each request;
use this parameter to avoid timeouts while trying to obtain over 10,000 results in a single request;
by specifying the unique offset_token value from the response array, you will get the subsequent results of the initial task;
offset_token values are unique for each subsequent task
Note: if the offset_token is specified in the request, all other parameters except limit will not be taken into account when processing a task
tag string user-defined task identifier
optional field
the character limit is 255
you can use this parameter to identify the task and match it with the result
you will find the specified tag value in the data object of the response

As a response of the API server, you will receive JSON-encoded data containing a tasks array with the information specific to the set tasks.

Description of the fields in the results array:

Field name Type Description
version string the current version of the API
status_code integer general status code
you can find the full list of the response codes here
Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions
status_message string general informational message
you can find the full list of general informational messages here
time string execution time, seconds
cost float total tasks cost, USD
tasks_count integer the number of tasks in the tasks array
tasks_error integer the number of tasks in the tasks array returned with an error
tasks array array of tasks
        id string task identifier
unique task identifier in our system in the UUID format
        status_code integer status code of the task
generated by DataForSEO; can be within the following range: 10000-60000
you can find the full list of the response codes here
        status_message string informational message of the task
you can find the full list of general informational messages here
        time string execution time, seconds
        cost float cost of the task, USD
        result_count integer number of elements in the result array
        path array URL path
        data object contains the same parameters that you specified in the POST request
        result array array of results
            offset_token string offset token for subsequent requests
you can use the string provided in this field to get the subsequent results of the initial task;
note: offset_token values are unique for each subsequent task
            total_count integer total amount of results in our database relevant to your request
            items_count integer the number of results returned in the items array
            items array contains citations and related data
                type string type of element = ‘content_analysis_search’
                url string URL where the citation was found
                domain string domain name
                main_domain string main domain
                url_rank integer rank of the url
this value is based on backlink data for the given URL from DataForSEO Backlink Index;
url_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article
                spam_score string backlink spam score of the url
this value is based on backlink data for the given URL from DataForSEO Backlink Index;
learn more about how the metric is calculated on this help center page
                domain_rank string rank of the domain
this value is based on backlink data for the given domain from DataForSEO Backlink Index;
domain_rank is calculated based on the method for node ranking in a linked database – a principle used in the original Google PageRank algorithm
learn more about the metric and how it is calculated in this help center article
                fetch_time string date and time when our crawler visited the page
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2017-01-24 13:20:59 +00:00
                country string country code of the domain registration
to obtain a full list of available countries, refer to the Locations endpoint
                language string main language of the domain
to obtain a full list of available languages, refer to the Languages endpoint
                score string citation prominence score
this value is based on url_rank, domain_rank, keyword presence in title, main_title, url, snippet
the higher the score, the more value the related citation has
                page_category array contains all relevant page categories
product and service categories relevant for the page
to obtain a full list of available categories, refer to the Categories endpoint
                page_types array page types
                ratings array ratings found on the page
all ratings found on the page based on microdata
                social_metrics array social media engagement metrics
data on social media interactions associated with the content based on website embeds developed and supported by social media platforms
                content_info object contains data on citations from the given url
                    content_type string type of content
example:
page_content, comment
                    title string title of the result
                    main_title string page title
                    previous_title string title of the previous content block
                    level integer title heading level
indicates h-tag level from 1 (top) to 6 (bottom)
                    author string author of the content
                    snippet string content snippet
                    snippet_length integer character length of the snippet
                    social_metrics array social media engagement metrics
data on social media interactions associated with the content based on website embeds developed and supported by social media platforms
                    highlighted_text string highlighted text from the snippet
                    language string content language
to obtain a full list of available languages, refer to the Languages endpoint
                    sentiment_connotations object sentiment connotations
contains sentiments (emotional reactions) related to the given citation and probability index per each sentiment
possible sentiment connotations: anger, happiness, love, sadness, share, fun
                    connotation_types object connotation types
contains types of sentiments (sentiment polarity) related to the given citation and probability index per each sentiment type
possible sentiment connotation types: positive, negative, neutral
                    text_category array text category
to obtain a full list of available categories, refer to the Categories endpoint
                    date_published string date and time when the content was published
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2017-01-24 13:20:59 +00:00
                    content_quality_score integer content quality score
this value is calculated based on the number of words, sentences and characters the content contains
                    semantic_location string semantic location
indicates semantic element in HTML where the target keyword citation is located
example:
article, header
                    rating object content rating
rating related to content_info
                        name string rating name
here you can find the following elements: Max5, Percents, CustomMax
                        rating_value integer the value of the rating
                        max_rating_value integer maximum value for the rating name
                        rating_count integer number of votes
                        relative_rating float relative rating
                    group_date string citation group date and time
indicates content publication date or date and time when our crawler visited the page for the first time;
this field can be used to group citations by date and display citation trends;
date and time are provided in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2017-01-24 13:20:59 +00:00

‌‌